home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Gold Collection / Software Vault - The Gold Collection (American Databankers) (1993).ISO / cdr35 / cvt2qb12.zip / TAG2BW.DOC < prev    next >
Text File  |  1993-04-08  |  17KB  |  416 lines
  1.  
  2.  
  3.                      B L U E  W A V E  M A I L  D O O R
  4.                              I N T E R F A C E
  5.                           I N S T R U C T I O N S
  6.  
  7.                         (Reprint From TAG2BW V4.1)
  8.  
  9.  
  10.  
  11.  
  12. Acknowledgements
  13. ~~~~~~~~~~~~~~~~
  14.                TAG is copyrighted by Victor Capton and Robert Numerick
  15.                    None of this interface package would be possible without
  16.                    the support the TAG team has give to third party utilities
  17.                    authors in terms of structures and functional programming
  18.                    aid. Special thanks go to Victor Capton, Paul Williams and
  19.                    Randy Goebel.. the current main force behind the TAG BBS
  20.                    systems.
  21.  
  22.                    Blue Wave is copyrighted by Cutting Edge Computing. The
  23.                    author is George Hatchew. Thanks go to George as well for
  24.                    providing insight into how the door interfaces with the
  25.                    QBBS V7.5 BBS system thus eliminating a couple of major
  26.                    brain busters.
  27.  
  28.  
  29. Guarantees/Warranties
  30. ~~~~~~~~~~~~~~~~~~~~~
  31.  
  32. Simply Put, There are no guarantees that this software will do anything
  33. but take up disk space. The author assumes no liability for any damages
  34. caused by running the related programs.. This disclaimer includes, but
  35. is not limited to loss of data, or destruction of files.
  36.  
  37. Blue Wave Files Needed
  38. ~~~~~~~~~~~~~~~~~~~~~~
  39.  
  40.         BW101_QB.ZIP    QBBS V2.75 Blue Wave Mail Door
  41.         BWAVE212.ZIP    Latest Blue Wave Reader
  42.  
  43.         Both Files are FREQable from Here (1:236/16)
  44.  
  45. Purpose
  46. ~~~~~~~
  47. This utility set is designed to ease the interface of the Blue Wave mail
  48. door and TAG BBS systems. The included programs create a QBBS V7.5
  49. system for use by the Blue Wave mail Door.. and any other QBBS V7.5 type
  50. door or utilities that need the resulting files.
  51.  
  52.  
  53. -=[ TAG2BW Documentation Page 1 ]=-               Main operation/use outline
  54.  
  55.  
  56. Use
  57. ~~~
  58. The use of these utilities is two step:
  59.  
  60.         1. Unzip the file CVT2QBBS into the Blue Wave Directory and
  61.            execute. Upon execution you will be prompted for two
  62.            directories. The first is the path to your Status.Dat File..
  63.            the second the path to the HMS base you are setting up. Bear in
  64.            mind the STATUS.DAT path you enter will be based upon the node you
  65.            are setting up. (see the recommended Multi-node setup later in the
  66.            docs) -=[ If You Use The *Optional* Parameter NOFILES then
  67.            there are no List Files created ]=-
  68.            -=[ NOTE ]=-
  69.                 To run as a nightly event and keep the message areas,
  70.                 files areas, and List files up to date enter the two
  71.                 paths on the command line as follows.
  72.                       CVT2QBBS C:\BBS C:\HMSPATH [NoFiles]
  73.  
  74.                 It is recommended you perform this maintenance for each node
  75.                 every night or after adding or deleting message or file areas.
  76.                 This program also creates standard QBBS V2.75 FILES.BBS files
  77.                 in each of your download directories.. if the directory is a
  78.                 CDROM drive then the list file is generated in the same
  79.                 directory as the *.DIR file and is named based on the
  80.                 following convention:
  81.                               F[File Area Number].BBS
  82.  
  83.                 So if a CDROM area is area #321 and the .DIR file was located
  84.                 in the multi-node directory the list file name would be:
  85.                                   C:\MULTI\F321.BBS
  86.  
  87.                 These list files are essential to Blue Wave's ability to allow
  88.                 users to request files via the door and should not be
  89.                 disturbed. The optional "NoFiles" parameter will
  90.                 override the list file creation thus eliminating the
  91.                 redundancy of this action on nodes that share all file areas.
  92.  
  93.            This program will create:
  94.  
  95.            QUICKCFG.DAT         QBBS system file similar to STATUS.DAT
  96.            MSGCFG  .DAT         Message Base Configuration/Definition
  97.            FILECFG .DAT         File Base Configuration/Definition
  98.            LIMITS  .CTL         Download/Upload Ratio and Time Control
  99.            FILES   .BBS         List File For User File Requests.
  100.            F[DIR#] .BBS         CDROM List File(s)
  101.            USERS   .BBS         QBBS User File (If Different From TAG)
  102.  
  103.            You  can also, optionally run the program SETDLK.EXE to create a
  104.            data file that will allow you to set daily download K limits for
  105.            your users. The usage is simple... Just Type SETDLK (in the QBBS
  106.            directory for the message base  or  node you are setting up) and
  107.            follow the instructions. You will be asked to give a  S/L  range
  108.            and then the download K (1mg = 1000K) to assign that S/L. If you
  109.            have  already  executed  the  program once before you can use the
  110.            program to edit  a  give  S/L  range  at  any  time. If the file
  111.            SLK.DAT exists in a given QBBS directory the information will be
  112.            used  when  creating  the  LIMITS.CTL  file,  and  when  writing
  113.            USERS.BBS and EXITINFO.BBS.
  114.  
  115.            Now you can run the Blue Wave setup Program BWUTILS.EXE and
  116.            toggle the board specific options. (Multi Node Setup Is Later
  117.            In Documentation so read EVERYTHING before starting!)
  118.  
  119.  
  120. -=[ TAG2BW Documentation Page 2 ]=-        Setting Up The Blue Wave Door....
  121.  
  122.                 General Information:
  123.                         Set packet name, Max Messages to download, Max
  124.                         Files for FREQ, and the various display files.
  125.  
  126.                 Overrides
  127.                         Any areas you wish to force or exclude. You can
  128.                         force exclusion from users even if they normally
  129.                         have access and can setup default areas which
  130.                         the users will use depending upon their normal
  131.                         access, or change the access requirements to be
  132.                         different than those on the BBS. You will only
  133.                         see the message area listing when you choose to
  134.                         insert a new area.. rest assured ALL of your HMS
  135.                         areas are known to Blue Wave.
  136.  
  137.                 Directories and paths
  138.                         Check these but they should all be correct
  139.                         except the local download, upload paths. The
  140.                         swap path should default to the path you have
  141.                         setup for TAG or none..
  142.  
  143.                         For multi-Node setups make sure your System
  144.                         Path points to the specific QBBS path for that
  145.                         Node Directory beneath Blue Wave.
  146.  
  147.                 Security level and flags
  148.                         This simply setups up default flags and flag
  149.                         override access for netmail. It defaults to the
  150.                         QBBS sysop security level of 32000 and you will
  151.                         need to make the appropriate changes. If you
  152.                         wish to toggle flag access just remember the TAG
  153.                         A/R flags are toggled as the first 27 flags so a
  154.                         use that had flags of @A--DEF would translate to
  155.                         XX--XXX in Blue Wave. (ALL Users have the @ flag)
  156.  
  157.  
  158.     You  MUST  repeat  this  for each node (call BWUTILS with the node's BW
  159.     parameter  file  as  the  argument  example:  BWUTILS  NODE2.PRM).  Pay
  160.     attention to  the  node  specific  directories  and paths information..
  161.     wouldn't want two Blue Wave users  crashing  into  each  other  in  the
  162.     dark <grin>.
  163.  
  164.  
  165. -=[ TAG2BW Documentation Page 3 ]=-     Interfacing TAG to the Blue Wave Door
  166.  
  167.  
  168.         2. Edit the included BW.BAT file and place it in your TAG BBS
  169.            directory then place the EXITINFO.EXE file in your Blue Wave
  170.            directory (or somewhere in the dos path). Add a menu option of
  171.                 Pkey    <
  172.                 Pdata   BW(??).BAT
  173.  
  174.            (You will need a separate Menu and Batch file for each HMS
  175.            directory. The "??" refers to NODE/HMSBASE Numbers)
  176.  
  177.           The files created by EXITINFO.EXE are:
  178.  
  179.                 EXITINFO.BBS    User information file that can be
  180.                                 changed by door
  181.                 ALIAS   .BBS    Alias file for users
  182.                 USERS   .BBS    All user information (like USER.LST)
  183.                 DORINFO?.DEF    Door drop file
  184.  
  185.  
  186. That should be about all I need tell you at this time other than read
  187. the Blue Wave Docs and you should easily see how to use these programs
  188. for setting up Multiple Nodes and HMS bases.
  189.  
  190. You will also note that Blue Wave will respect your user's handles and
  191. will Force Handles to be used on any area you force handles and will not
  192. allow handles in any area you have handles disabled... There is no such
  193. thing as anonymous on QBBS boards so these areas have handles forced.
  194.  
  195. A Word about local File Requests:
  196. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  197.  
  198. As stated earlier, it is crucial that a correctly formatted FILES.BBS or
  199. alternate list file exists for the file request options to work. Any files
  200. that are downloaded will applied toward the user's File download count and
  201. Download-K statistics. If the user is out of balance Blue Wave will not allow
  202. the user to download. If you are using another program to create your BBS's
  203. FILES.BBS please remember that it probably won't be placing the alternate list
  204. files in the correct place for the CDROMs and may well inhibit the user
  205. downloading ability. If there is a specific area you do NOT wish users to
  206. access via Blue Wave, regardless of their BBS access rights simply include a
  207. command in your maintenance batch file to delete that file area's FILES.BBS or
  208. alternate list file (F(are#).BBS).. then Blue Wave will treat the file as non
  209. existent even though it finds it in the appropriate directory.
  210.  
  211. As with TAG, Blue Wave will not charge Users for downloading from file
  212. areas  marked as Free <no ratios>. It will, however, limit their ability to
  213. download should they attempt to exceed  the daily download K you setup with
  214. the SETDLK program. (if you don't use this program then the default becomes
  215. 850K)
  216.  
  217.  
  218. -=[ TAG2BW Documentation Page 4 ]=-                            Mulitnode Setup
  219.  
  220. For sake of example we will demonstrate the multi-node setup using a Two node
  221. system with the following directory structure for the BBS:
  222.  
  223. Node 1:
  224.      BBS dir  = C:\BBS
  225.      Gfiles   = C:\BBS\GFILES
  226.      AFiles   = C:\BBS\AFILES
  227.      MSG Dir  = C:\MESSAGES
  228.  
  229. Node 2:
  230.      BBS DIr  = C:\BBS2
  231.      Gfiles   = C:\BBS2\GFILES
  232.      AFiles   = C:\BBS2\AFILES
  233.      MSG DIR  = C:\MESSAGES
  234.  
  235. Multinode
  236.      MULTI Dir = C:\MULTI
  237.            USERS   .LST
  238.            CDROM   .DIR FILES
  239.            MBOARDS .DAT
  240.            FBOARDS .DAT
  241. Main Blue Wave Directory = C:\BW
  242.  
  243. In the above example the directory tree would look like:
  244.  
  245. ROOT--+
  246.       |
  247.       +----+ BBS   <-------- NODE1 STATUS.DAT Directory
  248.       |        |
  249.       |        + AFILES
  250.       |        |
  251.       |        + GFILES
  252.       |
  253.       +----+ BBS2  <------- NODE2 STATUS.DAT Directory
  254.       |        |
  255.       |        + AFILES
  256.       |        |
  257.       |        + GFILES
  258.       |
  259.       +----+ BW    <------- Main Blue Wave Directory (includes all *.PRM
  260.       |       |                                       Files)
  261.       |       + NODE1  <----- NODE1 QBBS System Directory. Must Contain
  262.       |       |    |                CVT2QBBS.EXE
  263.       |       |    + DOWN
  264.       |       |    |
  265.       |       |    + UP
  266.       |       |    |
  267.       |       |    + WORK
  268.       |       |
  269.       |       + NODE2  <----- NODE2 QBBS System Directory. Must Contain
  270.       |            |                CVT2QBBS.EXE
  271.       |            + DOWN
  272.       |            |
  273.       |            + UP
  274.       |            |
  275.       |            + WORK
  276.       |
  277.       +----+ MESSAGES  <----- HMS Files (Single HMS Base System)
  278.       |
  279.       +----+ MULTI
  280.  
  281.  
  282.  
  283. -=[ TAG2BW Documentation Page 5 ]=-                         Mulitnode Setup
  284.  
  285. Given the preceding directory structure the calling conventions for each
  286. program would be:
  287.  
  288.         BWUTILS.EXE -  Called from main Blue Wave directory
  289.         ~~~~~~~~~~~
  290.                NODE1
  291.                    BWUTILS NODE1.PRM
  292.  
  293.                NODE2
  294.                    BWUTILS NODE2.PRM
  295.  
  296.         CVT2QBBS    - Called from Each C:\BW\NODE? Directory
  297.         ~~~~~~~~
  298.               NODE1
  299.                   CVT2QBBS C:\BBS C:\MESSAGES [NoFiles - optional]
  300.  
  301.               NODE2
  302.                   CVT2QBBS C:\BBS2 C:\MESSAGES [NoFiles - optional]
  303.  
  304.         EXITINFO      - Called from main Blue Wave Directory
  305.         ~~~~~~
  306.               NODE1
  307.                   EXITINFO %1 %2 %3 %4 %5 %6 %7 %8 C:\BW\NODE1 C:\BBS [NOOUT]
  308.  
  309.               NODE2
  310.                   EXITINFO %1 %2 %3 %4 %5 %6 %7 %8 C:\BW\NODE2 C:\BBS2 [NOOUT]
  311.  
  312.          BWMAIL     - Called from main Blue Wave Directory
  313.  
  314.               NODE1
  315.                   BWMAIL -CNODE1.PRM
  316.  
  317.                NODE2
  318.                   BWMAIL -CNODE2.PRM
  319.  
  320.          TAGUDATE   - Called From Main Blue Wave Directory
  321.          ~~~~~~~~
  322.                NODE1
  323.                   TAGUDATE C:\BW\NODE1 C:\BBS
  324.  
  325.                NODE2
  326.                   TAGUDATE C:\BW\NODE2 C:\BBS2
  327.  
  328. =============================[ Batch Files ]================================
  329.  
  330. NODE1
  331. ~~~~~
  332.      @Echo Off
  333.      C:
  334.      Cd\BW
  335.      EXITINFO %1 %2 %3 %4 %5 %6 %7 %8 C:\BW\NODE1 C:\BBS [NOOUT]
  336.      BWMAIL -CNODE1.PRM
  337.      TAGUDATE C:\BW\NODE1 C:\BBS
  338.      CD\BBS
  339.  
  340.  
  341.  
  342. -=[ TAG2BW Documentation Page 6 ]=-                         Multinode Setup
  343.  
  344. NODE2
  345. ~~~~~
  346.      @Echo Off
  347.      C:
  348.      Cd\BW
  349.      EXITINFO %1 %2 %3 %4 %5 %6 %7 %8 C:\BW\NODE2 C:\BBS2 [NOOUT]
  350.      :
  351.      : The Next Line is due to Blue Wave's lack of recognizing
  352.      : any DORINFO?.DEF file except DORINFO1.DEF
  353.      :
  354.      COPY C:\BW\NODE2\DORINFO2.DEF C:\BW\NODE2\DORINFO1.DEF
  355.      BWMAIL -CNODE2.PRM
  356.      TAGUDATE C:\BW\NODE2 C:\BBS2
  357.      CD\BBS2
  358.  
  359. As noted in the Batch file comments (any line preceded by a colon and not
  360. referred to as a Label is ignored by dos and serves as a comment) Blue Wave
  361. doesn't recognize node specific DORINFO?.DEF files.. I elected to create them
  362. anyway and allow the sysop to make the appropriate copy so the utility can
  363. serve to create the files for other QBBS V7.? Doors and utilities that do
  364. recognize the node specific DORINFO? naming convention.
  365.  
  366. Now for the multiple HMS systems. First off there is absolutely NO good
  367. reason for creating multiple HMS areas under TAG unless you have in excess
  368. of 200 messages areas (Lord) or your message base size has exceeded 16mg
  369. (Double oh lord).. This only serves to break other fine utilities, editors,
  370. etc, that would otherwise handle the message system flawlessly. As for data
  371. integrity, well you can always go back to the FIDO *.MSG message format.
  372. Really, the HMS system is pretty stable and shouldn't give you problems and
  373. if you end up with bad sectors you are likely to have other problems anyway.
  374.  
  375. To use the multiple HMS message bases the same rules apply as in the
  376. preceding example with the addition of a new QBBS system Dir for each extra
  377. HMS base... and of course a corresponding Blue Wave .PRM file. The additional
  378. directories would appear as :
  379.  
  380. BW
  381.  +
  382.  |
  383.  + NODE1     <---- CVT2QBBS resides here with node1 HMS1 paths
  384.  |    +
  385.  |    |
  386.  |    + HMS2 <---- CVT2QBBS resides here with NODE1 HMS2 paths
  387.  |    |
  388.  |    + HMS3 <---- CVT2QBBS resides here with NODE1 HMS3 Paths
  389.  |    |
  390.  |    + DOWN
  391.  |    |
  392.  |    + WORK
  393.  |    |
  394.  |    + UP
  395.  |
  396.  + NODE2     <---- CVT2QBBS resides here with NODE2 HMS 1 paths. The rest is
  397.  |    +                     is the same as above.
  398.  
  399. Naturally there would then be  NODE11.PRM, NODE12.PRM, NODE13.PRM files for
  400. Blue Wave and CVT2QBBS would have to be called from each directory with the
  401. paths pointing to the appropriate BBS node dir and HMS message base. heh..
  402. this is what you get for prostituting a *standard*.
  403.  
  404.  
  405.  
  406. -=[ TAG2BW Documentation Page 7 ]=-                               Postscript
  407.  
  408.  
  409. If there are any questions or comments direct them to:
  410.  
  411. Rick Cooper
  412. Just For the Heck Of It II
  413. 1:236/16
  414. (219) 747-5871
  415.  
  416.